Installation

Use this page when importing the asset into a project or verifying that a scene has the minimum wiring required for runtime playback.

Unity version

The codebase targets Unity 2021.3 LTS or newer. The project changelog also indicates validation across later LTS/editor versions.

Package dependencies

From the current Packages/manifest.json, the key runtime/editor dependencies are com.unity.textmeshpro, com.unity.ugui, and the editor GraphView APIs used in authoring tools.

Scene setup checklist

Add a DialogManager to the scene.
Assign a DialogUIController to DialogManager.uiPanel.
Assign an AudioSource if voice or UI audio is required.
Add one or more DialogGraph entries in dialogGraphs.
Map each graph to a stable dialogID.

Common integration miss If the graph exists but the conversation does not start, the missing piece is often the dialogID mapping on the manager rather than the graph asset itself.

Optional runtime pieces

DialogActionRunner if you use action nodes
DialogueHistory and DialogueHistoryView if you want backlog support

Global settings asset

The settings runtime loader expects the master settings asset at Resources/DialogSettingsSO/DialogSystemSettings. In this repository, the editor settings window creates and maintains that asset automatically.

Open Tools â†’ Dialogue Graph System â†’ Settings to create or verify the master settings asset and its sub-assets.

Input system notes

The code supports legacy input and newer input packages through InputHelper. If you use the new Input System only, make sure the scene EventSystem is configured accordingly.

Optional add-ons

Optional AI tooling is documented separately so the DGS installation docs stay focused on the core product. If you are enabling the AI authoring add-on or provider layer, use the dedicated product docs in Dialogue Graph AI Extension and AI Providers.

Verify your install

Open Assets/DialogGraphSystem/DemoScenes/DialogueDemo.unity.
Enter Play Mode and select any of the three sample graphs from the demo menu.
Confirm line reveal, choice display, and skip/autoplay behavior.
Open the graph editor via Tools â†’ Dialogue Graph System â†’ Dialogue Graph and load one of the sample graphs from Assets/DialogGraphSystem/Graphs/.

Suggested visuals

DialogManager inspector

Shows graph mapping, UI panel assignment, and optional runner wiring.

Settings window

Shows how the global settings asset is created and managed.